Aller au contenu principal

Description des options générales

Ce module est disponible à partir des versions postérieures au 20260507

Plusieurs interfaces ui_element acceptent une table d’options permettant d’indiquer l’application cible, le nombre de résultats, la profondeur de récursion, la vérification de détection et le pas de défilement.

Options de requête​

local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
  • pid
    type entier, identifiant de processus de l’application cible. En l’absence de valeur, l’application au premier plan est généralement utilisée.
  • max_level
    type entier, profondeur de récursion des éléments enfants. Les valeurs 1 ou 2 sont couramment utilisées pour contrôler la quantité de données renvoyées.
  • max_elements
    type entier, nombre maximal d’éléments de premier niveau renvoyés.
  • fallback_children
    type booléen, tente de lire les éléments enfants lorsque la liste ordinaire est vide. La valeur par défaut varie selon l’interface.
  • include_hit_state
    type booléen, indique s’il faut compléter les champs de l’état de détection.
  • hit_test
    type booléen, indique s’il faut activer la détection par échantillonnage de l’écran. Les scripts ordinaires n’ont généralement pas besoin de l’activer.
  • fallback_hit_test
    type booléen, indique s’il faut tenter la détection par échantillonnage lorsque la liste ordinaire est vide.
  • hit_test_spacing
    type numérique, espacement des échantillons à l’écran, en coordonnées logiques. 40 par défaut.

Options d’exclusion d’attributs​

Disponibles à partir de 20261115. Uniquement pour snapshot() et list_text_elements(). Toutes sont booléennes, valent false par défaut et s’appliquent aussi aux éléments enfants. Si ces états ne sont pas nécessaires, activer les options d’exclusion peut réduire le coût des requêtes et accélérer la capture des instantanés.

  • exclude_visibility
    Avec true, ignore les requêtes de visibilité et omet isVisible.
  • exclude_map
    Avec true, ignore la vérification de l’attribut de carte et omet isMap ; les éléments de carte sont conservés.
  • exclude_hit_state
    Avec true, ignore les vérifications de hit au point central et omet canHit, hitVerified, hitTestPoint et hitTestPointLogical. Ne peut pas être combinée avec include_hit_state = true.

L’ensemble des éléments, le texte, les coordonnées et les règles de recherche complémentaire d’éléments de hit_test / fallback_hit_test restent inchangés. N’excluez pas un champ d’état si vous devez filtrer selon ce champ.

Options d’action​

  • point
    type table, point utilisé pour le défilement ou la détection, par exemple { x = 200, y = 700 }, en pixels physiques.
  • x / y
    type entier, équivalents de point, pouvant être placés directement dans la table d’options.
  • steps
    type numérique, paramètre de pas utilisé pour les opérations de défilement, d’augmentation ou de diminution. L’effet exact dépend du contrôle cible.

Description​

list_text_elements() est plus conservatrice par défaut pour assurer la compatibilité avec les anciens scripts. find(), find_all(), snapshot() et les interfaces d’action conviennent mieux à une utilisation directe dans les nouveaux scripts. hit_test peut renvoyer un élément plus proche de la couche supérieure actuelle de l’interface, mais son coût est plus élevé ; il est recommandé de ne l’utiliser que si une requête ordinaire ne trouve aucun élément.